Skip to content

feat: more approachable & in-depth indexer intro#2055

Merged
ElliotFriend merged 1 commit intostellar:mainfrom
theahaco:feat/better-indexers-overview
Dec 19, 2025
Merged

feat: more approachable & in-depth indexer intro#2055
ElliotFriend merged 1 commit intostellar:mainfrom
theahaco:feat/better-indexers-overview

Conversation

@chadoh
Copy link
Contributor

@chadoh chadoh commented Nov 20, 2025

Clean up the Data section's sidebar and add MUCH more info & context to the "Data -> Indexers" page.

While mostly adding info, this removes the small Goldsky tutorial+screenshots that had been on this page. I'm not sure our documentation is the right place to walk through a partner's solution in this way. We already link out to Goldsky's documentation, which is quite good, containing more & better screenshots than what we had. Additionally, this sort of tutorial-via-screenshots content did not fit as well within the reworked Indexers homepage, which is a bit higher-level. I wasn't sure it was worth keeping this content anywhere, and decided to remove it for now.

@chadoh chadoh force-pushed the feat/better-indexers-overview branch 2 times, most recently from 35941a1 to 272a74f Compare November 26, 2025 15:55
@chadoh chadoh force-pushed the feat/better-indexers-overview branch 4 times, most recently from 0205b40 to bdc9e38 Compare December 12, 2025 18:50
@chadoh chadoh force-pushed the feat/better-indexers-overview branch 2 times, most recently from 80dcc07 to 15358ee Compare December 17, 2025 20:05
@chadoh chadoh marked this pull request as ready for review December 17, 2025 20:06
chadoh added a commit to theahaco/stellar-docs that referenced this pull request Dec 19, 2025
"deprecated", to my engineering-trained mind, means "there is a better
alternative available that you should now switch to."

There is ***no*** viable alternative to Horizon today. We therefore
cannot declare it to be deprecated.

When I read that it is _already_ deprecated, it makes me think I can
avoid using it in a project. If I cannot realistically avoid using it,
at least not without great cost in both engineering research time and
infrastructure bills, then the assertion that it is already deprecated
will cause me distress.

Once we have good Portfolio API-style indexing services in place, with
freemium models appropriate for the whole gamut of
hackathon-startups-to-enterprises, then we can consider Horizon to be
deprecated. Until then, there's just no other reasonable way to get a
whole host of necessary data, such as token balances and circulating
supply.

This updates the "Horizon is deprecated" warning to say that it _will_
be deprecated in the future, deep-linking to the "Portfolio APIs"
section of the [newly-revamped indexers page][1].

  [1]: stellar#2055
@chadoh chadoh force-pushed the feat/better-indexers-overview branch from 15358ee to c000e8f Compare December 19, 2025 15:51
@chadoh chadoh force-pushed the feat/better-indexers-overview branch 2 times, most recently from b4bec0f to e1f8a1b Compare December 19, 2025 16:02
Copy link
Contributor

@ElliotFriend ElliotFriend left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

some minor nits here and there, and some questions left throughout.

the headline, though: This looks like a great change!!! thank you so much!!

Clean up the Data section's sidebar and add MUCH more info & context to
the "Data -> Indexers" page.

While mostly adding info, this removes the small Goldsky
tutorial+screenshots that had been on this page. I'm not sure our
documentation is the right place to walk through a partner's solution in
this way. We already link out to Goldsky's documentation, which is quite
good, containing more & better screenshots than what we had.
Additionally, this sort of tutorial-via-screenshots content did not fit
as well within the reworked Indexers homepage, which is a bit
higher-level. I wasn't sure it was worth keeping this content anywhere,
and decided to remove it for now.

Co-authored-by: Elliot Voris <elliot@voris.me>
@chadoh chadoh force-pushed the feat/better-indexers-overview branch from 1ded476 to 66392a3 Compare December 19, 2025 18:52
Copy link
Contributor

@ElliotFriend ElliotFriend left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice work!!!! 🎉

@ElliotFriend ElliotFriend merged commit a339808 into stellar:main Dec 19, 2025
5 of 6 checks passed
@chadoh chadoh deleted the feat/better-indexers-overview branch December 19, 2025 20:06
chadoh added a commit to theahaco/stellar-docs that referenced this pull request Dec 20, 2025
"deprecated", to my engineering-trained mind, means "there is a better
alternative available that you should now switch to."

There is ***no*** viable alternative to Horizon today. We therefore
cannot declare it to be deprecated.

When I read that it is _already_ deprecated, it makes me think I can
avoid using it in a project. If I cannot realistically avoid using it,
at least not without great cost in both engineering research time and
infrastructure bills, then the assertion that it is already deprecated
will cause me distress.

Once we have good Portfolio API-style indexing services in place, with
freemium models appropriate for the whole gamut of
hackathon-startups-to-enterprises, then we can consider Horizon to be
deprecated. Until then, there's just no other reasonable way to get a
whole host of necessary data, such as token balances and circulating
supply.

This updates the "Horizon is deprecated" warning to say that it _will_
be deprecated in the future, deep-linking to the "Portfolio APIs"
section of the [newly-revamped indexers page][1].

  [1]: stellar#2055
briwylde08 pushed a commit that referenced this pull request Jan 5, 2026
"deprecated", to my engineering-trained mind, means "there is a better
alternative available that you should now switch to."

There is ***no*** viable alternative to Horizon today. We therefore
cannot declare it to be deprecated.

When I read that it is _already_ deprecated, it makes me think I can
avoid using it in a project. If I cannot realistically avoid using it,
at least not without great cost in both engineering research time and
infrastructure bills, then the assertion that it is already deprecated
will cause me distress.

Once we have good Portfolio API-style indexing services in place, with
freemium models appropriate for the whole gamut of
hackathon-startups-to-enterprises, then we can consider Horizon to be
deprecated. Until then, there's just no other reasonable way to get a
whole host of necessary data, such as token balances and circulating
supply.

This updates the "Horizon is deprecated" warning to say that it _will_
be deprecated in the future, deep-linking to the "Portfolio APIs"
section of the [newly-revamped indexers page][1].

  [1]: #2055
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants